_p_o_r_t is the audio input port from which you want to read samples.
This is the returned value of an aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt((((3333ddddmmmm)))) call.
_b_u_f_s is an array of pointers to sample buffers, each element of
which corresponds to a single channel of audio input.
_s_t_r_i_d_e_s is an array of integers, one corresponding to each input
channel. Each element indicates the number of interleaved
channels you desire in the sample buffer for that channel.
_f_r_a_m_e_c_o_u_n_t is the number of sample frames that you want to read from
the audio port.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
aaaallllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrrssss transfers data from an audio port to a set of buffers, or
to different locations in a single buffer. aaaallllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrrssss allows the
application to specify how the data is to be interleaved.
_b_u_f_s is an array of pointers to sample buffers. Each element of _b_u_f_s
corresponds to one input channel. If the element is 0, that channel will
be ignored; this allows an application to only read audio from the
channels of interest.
The sample buffers can be arbitrarily interleaved; the _s_t_r_i_d_e_s parameter
indicates the number of channels in each target sample buffer. For
example, if _s_t_r_i_d_e_s[_n] is 1, then bufs[n] will be mono; if _s_t_r_i_d_e_s[_n] is
2, then bufs[n] will be interleaved stereo, and aaaallllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrrssss will write
to every other sample in that buffer. The elements of _s_t_r_i_d_e_s can have
any value. If _s_t_r_i_d_e_s is 0, all the sample buffers will be mono, and
aaaallllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrrssss does non-interleaved input.
There must be exactly as many elements in _b_u_f_s and _s_t_r_i_d_e_s as the number
of channels specified for the port with aaaallllSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllssss((((3333ddddmmmm)))).
aaaallllRRRReeeeaaaaddddBBBBuuuuffffffffeeeerrrrssss blocks until _f_r_a_m_e_c_o_u_n_t sample frames have been read from
the port. If you do not wish to block, make sure that _f_r_a_m_e_c_o_u_n_t is less
than the return value of aaaallllGGGGeeeettttFFFFiiiilllllllleeeedddd((((3333ddddmmmm)))).
The target format of each sample depends upon the configuration of the
audio port. Each sample can be an 8-, 16-, or 32-bit integer, or a
single- or double-precision floating-point value or subcode data; see
aaaallllSSSSeeeettttSSSSaaaammmmppppFFFFmmmmtttt((((3333ddddmmmm)))) and aaaallllSSSSeeeettttWWWWiiiiddddtttthhhh((((3333ddddmmmm)))) for a description of how these